home *** CD-ROM | disk | FTP | other *** search
/ Experimental BBS Explossion 3 / Experimental BBS Explossion III.iso / graphics / qpeg11c.zip / QPEG.DOC < prev    next >
Text File  |  1993-11-18  |  11KB  |  236 lines
  1. -----------------------------------------------------------------------------
  2.  
  3.                                    Q P E G
  4.                                  ___________
  5.                                  ~^~^~^~^~^~
  6.  
  7.       A fast JPEG viewer for MS-DOS.  VGA graphics and 80386+ required.
  8.       ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  9.  
  10. Copyright (c) 1993 by TBH-Softworx -- all rights reserved
  11.           Oliver Fromme, Klingestr. 2, 38640 Goslar, Germany
  12.           Internet email: inof@asterix.rz.tu-clausthal.de
  13.  
  14. Version 1.1c of 19-Nov-1993
  15.  
  16. This program is Shareware.  You may copy it, use it, give it to your friends,
  17. upload it to a BBS or something similar, under the following conditions:
  18.  
  19.  * Don't charge any money for it.  If you upload it to a BBS, make sure that
  20.    it can be downloaded free (without paying for downloading it, except
  21.    for usage fees that have to be paid anyway).
  22.  * Only distribute the whole original package, with all the files included.
  23.  * Don't change the files in any way, except:
  24.    You may change the INI, CFG, ASM, and DRV files for private purposes.
  25.    Don't distribute modified versions of these files to others without
  26.    prior permission of the author of QPEG.
  27.  * QPEG may not be part of any commercial product or service without my
  28.    written permission.
  29.  * QPEG may not be used in any corporate or gouvernment institution without
  30.    being registered.
  31.  
  32. This software consists of the following files:
  33.  - QPEG.EXE        the main executable file
  34.  - QPEG.INI        initialization file (ASCII text)
  35.  - QPEG.DAT        data file for QPEG (don't modify!)
  36.  - QPEG.DO?        the documentation
  37.  - CHANGES.DO?     list of changes from previous versions
  38.  - INSTALL.DO?     how to configure QPEG
  39.  - FAQ.DO?         frequently asked questions
  40.  - REGISTER.FRM    registration form
  41.  - JPEGUNIT.PAS    order form for the JPEG Pascal unit
  42.  - TBHGLOGO.RLE    TBH logo for user interface
  43.  - CFG\*.CFG       various configuration files
  44.  - CFG\CFG.DOC     description of the configuration file format
  45.  - DRV\*.DRV       various video driver files
  46.  - DRVSRC\*.ASM    source codes for the video drivers
  47.  - DRVSRC\DRV.DOC  description of the video driver file format
  48. Text files with a DOK extension are German, those with a DOC extension
  49. are English.
  50. There may also be some example JPEG files.  They are not part of the QPEG
  51. software package.
  52.  
  53. IMPORTANT:  Using modes that your hardware (graphics card and/or monitor)
  54. can't handle can damage your hardware!  Be sure to use only supported
  55. modes.  If you come across a mode which looks flickering or unstable
  56. (i.e. the monitor can't hold the picture), abort QPEG immediately and
  57. delete that mode from the configuration file.
  58.  
  59. YOU ARE USING QPEG AT YOUR OWN RISK!  THE AUTHOR (OLIVER FROMME) IS NOT
  60. RESPONSIBLE FOR ANY DAMAGE CAUSED BY THE USE OF QPEG OR BY THE INABILITY
  61. TO USE QPEG.  IF YOU ARE NOT SURE ABOUT THIS, OR IF YOU DON'T ACCEPT THIS,
  62. THEN DO NOT USE QPEG!
  63.  
  64. QPEG is inexpensive shareware.  If you continue using it after a trial
  65. period of 30 days, you are encouraged to pay a small registration fee.
  66. (I try to avoid saying that you MUST register, but actually you MUST.)
  67. The registration is valid for all future updates.  The source code of the
  68. JPEG decoding routines used by QPEG is also available.
  69. To become a registered user, please print the file REGISTER.FRM and send
  70. it to me with appropriate payment.  If you want to get the JPEG source code,
  71. print the file JPEGUNIT.PAS instead.
  72.  
  73. All product names mentioned in this software are trademarks or registered
  74. trademarks of their respective owners.
  75.  
  76. -----------------------------------------------------------------------------
  77.  
  78. What is QPEG?
  79. ~~~~~~~~~~~~~
  80.  
  81. QPEG (Quick-jPEG, pronounce "Q-Peg" [kju:peg]) is a viewer for JPEG image
  82. files.  As far as I know, it is the fastest viewer available for MS-DOS
  83. based computers.
  84.  
  85. JPEG (Joint Photographic Experts Group, pronounce "Jay-Peg") is an image file
  86. format which uses a "lossy" compression.  JPEG images (they have usually a
  87. "JPG" file extension) are normally very small and offer better compression
  88. than any other image format.
  89.  
  90. Decoding of JPEG images is a rather complicated process, thus it needs a lot
  91. of computing power and performance.  QPEG takes advantage of the advanced
  92. features of 80386 CPUs, and it uses large look-up tables instead of formulas.
  93. Well, I don't want to get into details.  It's fast, that's all you could want
  94. to know.
  95.  
  96.  
  97. Features
  98. ~~~~~~~~
  99.  
  100.  - It's fast (have I mentioned that before?).
  101.  - Nice preview ability which is even faster (lets you quickly browse through
  102.    lots of images, very useful if you're searching for a certain image).
  103.  - Works even with a standard VGA card (320x200x16, 640x480x16, 320x200x256).
  104.  - Supports many SVGA cards (virtually all with VESA capability).
  105.  - Uses truecolor (16M color), hicolor (32K color), 256 color (either
  106.    greyscale or dithered color), and 16 color (dithered greyscale) modes.
  107.  - You can pan across an image which is bigger than the current screen
  108.    resolution (scrolling).  Some XMS and/or EMS memory is needed for this.
  109.  - You can change the resolution without loading/decoding the image again
  110.    (this is restricted to the same color resolution, for example you can't
  111.    switch from hicolor to truecolor without reloading the image).
  112.  - Supports also GIF images (interlaced and non-interlaced).
  113.  
  114.  
  115. Requirements
  116. ~~~~~~~~~~~~
  117.  
  118.  - 80386 or better CPU (33 MHz minimum recommended)
  119.  - VGA graphics card (SuperVGA recommended, though QPEG will run on any
  120.    standard VGA card)
  121.  - some XMS and/or EMS memory (depending on the size of the images), though
  122.    QPEG will also run without any XMS/EMS, but then you will be unable to
  123.    do any panning/scrolling
  124.  - MS-DOS 5.0
  125.  
  126.  
  127. Using QPEG
  128. ~~~~~~~~~~
  129.  
  130. At first you have to configure QPEG for your video hardware.  Please read
  131. the file INSTALL.DOC for more information.
  132.  
  133. Then just type 'QPEG' to run it.  There are some command line options
  134. (type 'QPEG /?' to get a help message), but they're usually not needed.
  135.  
  136. The graphical user interface of QPEG is rather intuitive, so there is no need
  137. for much documentation.  At the top of the screen there's a list of all
  138. keyboard functions.  Hit '?' to get a list of keys that can be used while
  139. viewing an image.  You can quit QPEG at any time by hitting Alt-X.
  140.  
  141. QPEG can also be used as command line viewer (without graphical user
  142. interface).  Type 'QPEG' followed by one or more names of files or
  143. directories.  Wildcards ('*' and '?') are allowed, too.
  144.  
  145.  
  146. Restrictions and Bugs
  147. ~~~~~~~~~~~~~~~~~~~~~
  148.  
  149. The basic JPEG decoding routines of QPEG are written for maximum speed,
  150. there's no time for error checking, thus QPEG may lock up your PC if it tries
  151. to decode a corrupt JPEG file.  To prevent that, you can decode the defective
  152. file using another JPEG decoder (for example DJPEG by Tom Lane / IJG) and
  153. compress it again.  The resulting JPEG file should be decodable by QPEG
  154. without any problems.
  155.  
  156. QPEG can't handle all kinds of JPEG images.  Specifically, it can only decode
  157. files which comply with the JFIF standard.  See 'Technical Information' below
  158. for more details.
  159.  
  160. The maximum image width is 4000 pixel.  QPEG will refuse to decode larger
  161. images.  The image height is not limited, but if it's too large it may not
  162. fit into memory (XMS/EMS), thus you can't see the bottom part when scrolling
  163. down.  If this happens, try to use a video mode with less colors, because it
  164. needs less memory.  Or buy more memory :-)
  165.  
  166.  
  167. How to get an updated version of QPEG
  168. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  169.  
  170. This version is most probably not the last one.  There are several ways
  171. to get an up-to-date version of QPEG:
  172.  
  173.  - You can get it free by FTP via The Internet.  Of course that's only
  174.    possible if you've got access to The Internet.  You can find QPEG at
  175.    'ftp.tu-clausthal.de' (139.174.2.10) in /pub/msdos/graphics. There's
  176.    also a mail server available at 'mail-server@rz.tu-clausthal.de'.
  177.  
  178.  - You can get it by registering QPEG.  See REGISTER.FRM for more
  179.    information.  The registration is valid for all future updates of QPEG.
  180.  
  181.  - If you're already a registered user, you can get an updated version
  182.    free by electronic mail (email).  If this is not possible, you can get
  183.    it on disk via normal "snail" mail, but that costs 10 $US or 10 DM
  184.    to cover my expenses.  Before sending me money, make sure that there
  185.    IS an updated version (otherwise you might be disappointed because you
  186.    got the same version you already have).
  187.    You can find my mail and email addresses at the top of this documentation
  188.    or by entering 'QPEG /?'.
  189.  
  190.  
  191. Future Enhancements
  192. ~~~~~~~~~~~~~~~~~~~
  193.  
  194. As mentioned before, this is probably not the last version of QPEG.
  195. These features are planned for future versions:
  196.  - Support for more image formats, e.g. Targa, PCX, BMP.
  197.  - Mouse support (point and click).
  198.  - Tagging multiple files and view them in sequence.
  199.  - Slideshow option (preloading images, but panning disabled).
  200.  - Shrinking of big images.
  201.  - Option for automatically choosing the appropriate video mode.
  202.  - Support for more SVGA cards.  If you've written a working video driver
  203.    that isn't already distributed with QPEG, I would be most grateful if
  204.    you send it to me.
  205.  - More enhancements.  If you have any ideas, wishes, comments etc, please
  206.    let me know.
  207.  
  208.  
  209. Technical Information
  210. ~~~~~~~~~~~~~~~~~~~~~
  211.  
  212. QPEG can decode greyscaled images (containing a single component using h1v1
  213. upsampling) and YCbCr true color images (containing three interleaved
  214. components in a single scan, using either Yh2v2, Yh2v1 or Yh1v1 upsampling
  215. for Y and Ch1v1 for Cb/Cr), covering virtually all JFIF files in use today.
  216.  
  217. QPEG can handle files that contain restart markers, but it will not use them
  218. for error recovery.  QPEG can also display JPEG files which were created
  219. with the 'Adobe Photoshop' (at least version 2.5).
  220.  
  221. The basic JPEG decoding routines are written in pure 386 assembly language,
  222. everything else is written using Borland Pascal 7.0.  I am not using
  223. protected mode, because it would slow down the decoding rather than speeding
  224. it up.  I have linked the JPEG routines into a single easy to use Pascal
  225. unit, which can also be used within other applications.  If you want to
  226. purchase the unit, please print the file JPEGUNIT.PAS and send it to me with
  227. appropriate payment.
  228.  
  229. The JPEG unit provides procedures to open and close a JPEG file, read the
  230. file header, and read the image row by row.  It contains routines which
  231. output the lines as 24 bit true color RGB/BGR, 15 bit hicolor, 256 color
  232. dithered, 256 color greyscaled, 16 color grayscaled/dithered, and 16 color
  233. greyscaled/dithered for preview (scaled to one eigth or one fourth).
  234.  
  235. -----------------------------------------------------------------------------
  236.